سرویس «استعلام کد ملی (Client Credential)» در دسته احراز هویت و شناخت مشتری فینوتک با گرفتن کد ملی و تاریخ تولد، اطلاعات ثبت احوال شخص — از جمله نام، نام خانوادگی، نام پدر و وضعیت حیات — را برمیگرداند. با این سرویس میتوانید بدون نیاز به تایید پیامکی کاربر، درستی هویت اعلامشده در فرمها و پایگاه داده خود را بسنجید.
نام و کد ملی، کلید اتصال یک پرونده به یک انسان واقعی است، اما در عمل هر دو دستنویس وارد میشوند: کاربر نام خود را با غلط تایپی مینویسد، کد ملی را یک رقم اشتباه میزند یا کد ملی شخص دیگری را ثبت میکند. تشخیص این خطاها بهصورت سنتی یعنی درخواست تصویر شناسنامه یا کارت ملی، انتظار برای پاسخ مشتری و بازبینی دستی کارشناس؛ فرآیندی که هم روزها طول میکشد و هم به قضاوت انسانی وابسته است. در پروندههای انبوه — مثل فهرست مشتریان قدیمی یا فهرست ذینفعان یک پرداخت گروهی — این روش عملاً قابل اجرا نیست.
استعلام کد ملی (Client Credential) چیست؟
سرویسی است که با دریافت کد ملی و تاریخ تولد، اطلاعات ثبت احوال شخص — نام، نام خانوادگی، نام پدر، تاریخ تولد و وضعیت حیات — را بهصورت داده ساختیافته برمیگرداند تا هویت اعلامشده مشتری سنجیده شود.
تفاوت این سرویس با نسخه Authorization SMS چیست؟
خروجی یکی است، مسیر دسترسی متفاوت: این نسخه با توکن Client Credential و بدون تایید پیامکی فراخوانی میشود و برای پردازشهای سمت سرور و بازبینی انبوه مناسب است؛ اگر جریان کاری شما باید رضایت خود شخص را ثبت کند، استعلام کد ملی (Authorization SMS) را انتخاب کنید.
آیا این سرویس فقط اعتبار کد ملی را بررسی میکند؟
نه؛ علاوه بر صحت کد ملی، اطلاعات هویتی متناظر آن هم بازگردانده میشود و میتوانید آن را با اطلاعات مشتری در سامانه خود تطبیق دهید.
تفاوت این سرویس با استعلام وضعیت حیات چیست؟
اگر تنها به وضعیت حیات نیاز دارید، استعلام وضعیت حیات پاسخ متمرکزتری میدهد؛ این سرویس وضعیت حیات را در کنار مجموعه کاملتری از اطلاعات هویتی برمیگرداند.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.